home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / qked240a.zip / MAXIMUS.ZIP / MAXIMUS.DOC < prev   
Text File  |  1997-07-14  |  8KB  |  231 lines
  1.  
  2. Setting up QuikEdit v2.40 with Maximus v3
  3. Based off of notes made by Chris Gerlinsky
  4.                    
  5.  
  6.                Configuring QuikEdit (EDITCFG.EXE)
  7.  
  8.  
  9.  
  10. Toggles
  11.   |
  12.   +- Toggle Menu 1
  13.   | |
  14.   | Use Overrides    NO
  15.   | Filter ANSi      NO
  16.   | Use Soft C/Rs    YES
  17.   |
  18.   +- Toggle Menu 2
  19.     |
  20.     Quote Format    YES
  21.     QBBS Compatible YES
  22.     Message Header  NO
  23.     Kludge Filter   YES
  24.  
  25. Other
  26.   |
  27.   +- Dropfile Type
  28.     |
  29.     Dorinfo1.Def
  30.  
  31.  
  32.  
  33. Directory Setup:
  34.  
  35. Made Sure your QuikEDIT environmental value is set to reflect QuikEdit's 
  36. path.  For example, if QuikEdit is located in C:\MAXIMUS\QUIKEDIT, your 
  37. SET command would look like:
  38.  
  39.     SET QUIKEDIT=C:\MAXIMUS\QUIKEDIT
  40.  
  41. Make sure you place the statement in your config.sys, or in the batch file 
  42. that calls your BBS.  
  43.  
  44. The path where my drop files, etc, are to be found, is C:\Bbs\Max\%k\, 
  45. so for node 1 it is: C:\Bbs\Max\1\ and for node 2 it is C:\Bbs\Max\2\.
  46.  
  47. That is also the path where QuikEdit will find DORINFO1.DEF, and where it 
  48. wants to find MSGTMP, MSGINF, and where it wants to write MSGTMP.
  49.  
  50. My BBS is also configured so that Uses Leaving in MAX.CTL points to 
  51. Misc\Leaving.Bbs, which will in turn call up the correct MECCAs
  52. to create a DORINFO1.DEF, DOOR.SYS, CHAIN.TXT, and CALLINFO.TXT, all 
  53. automatically whenver an external program is run.
  54.  
  55. If you do not have many/any doors, etc, setup, you may want to adopt a 
  56. system such as this.  A sample DORINFO.MEC is:
  57.  
  58. ---------------------------------------------------------------
  59. [delete]%k\dorinfo1.Def
  60. [open]%k\dorinfo1.Def
  61. [write]%N[ comment           Write the BBS name             ]
  62. [write]%S[ comment           Write the SysOp's first name   ]
  63. [write]%s[ comment           Write the SysOp's last name    ]
  64. [islocal write]COM0 [ comment          Write the COM port   ]
  65. [isremote iftask]1  [write]COM2[comment local is always COM0 ]
  66. [write]%b BAUD,N,8,1     [comment Write the baud rate            ]
  67. [write] 0[ comment           Say that we're not networked   ]
  68. [write]%A[ comment           Write the user's first name    ]
  69. [write]%B[ comment           Write the user's last name     ]
  70. [write]%c[ comment           Write the user's city          ]
  71. [write]%g[ comment           Write the user's graphics      ]
  72. [write]%o[ comment           Write the user's security level]
  73. [write]%t[ comment           Write the user's time remaining]
  74. [write]-1[ comment           Say that we're using a FOSSIL  ]
  75. [quit      comment           And we're done!                ]
  76. ---------------------------------------------------------------
  77.  
  78. (I've modified DOORSYS.MEC, CALLINFO.MEC, and WWIV.MEC all in the
  79. same way as the above)
  80.  
  81.  
  82. However, there is a small problem with this.  Maximus doesn't seem to want 
  83. to call LEAVING.MEC when it runs the external editor! (Although making 
  84. LEAVING.MEC call the DORINFO1, DOORSYS, etc, door files is still a 
  85. nifty idea <g>)
  86.  
  87. So, that means that we have to find another way to always have a
  88. DORINFO1.DEF ready for QuikEdit.
  89.  
  90. Actually, it's not even really a problem.  As long as a single DORINFO1.DEF 
  91. has been created since the user logged on, all should be well - we're also 
  92. passing the user's time left to QuikEdit via a command-line parameter.  
  93. (IOW, just call DORINFO1.MEC from your WELCOME.MEC, and you'll be OK)
  94.  
  95. That takes care of creating the DORINFO1.DEF as (assuming node 1) 
  96. \bbs\max\1\dorinfo1.def.  Now, all we need to do is to create the
  97. \bbs\max\1\msgtmp.
  98.  
  99. Maximus doesn't seem to have a way to handle this internally, so
  100. we'll do it in our batch file.
  101.  
  102.                          QUIK.BAT
  103.  
  104. Our C:\BBS\QUIKEDIT\QUIK.BAT should be setup as follows:
  105.  
  106.     @echo off
  107.     cd\bbs\max\%2
  108.     copy /y c:\bbs\max\%1 msgtmp>nul
  109.     cd\bbs\Quikedit
  110.     Quikedit /D:\bbs\max\%2\ /N:%2 /T:%3
  111.     cd\bbs\max\%2
  112.     copy /y msgtmp c:\bbs\max\%1>nul
  113.  
  114. Note:  If you're not using DOS 6.0 (??) or higher, you will likely
  115.     have to edit the two copy lines.  (the /y causes DOS 6.0+ to
  116.     overwrite any existing files w/o prompting)
  117.  
  118. An explanation of the above:
  119.  
  120. cd\bbs\max\%2                      <-  That changes to the \bbs\max\1 
  121.                                 directory, assuming the node 
  122.                                 number is 1.
  123.  
  124. copy /y c:\bbs\max\%1 msgtmp>nul   <- That copies the TEMP\MSGTMP01.$$$
  125.                                 to MSGTMP, assuming node 1. ( The >nul
  126.                                 suppresses output)
  127.  
  128. cd %quikedit%                      <-  Changes to your QuikEdit directory
  129.  
  130. Quikedit /D:\bbs\max\%2\ /N:%2     <- Starts QuikEdit, tells it that the
  131.                                 drop file (DORINFO1.DEF) and MSGTMP 
  132.                                 are found in \bbs\max\1 (assuming node 
  133.                                 1), and tells QuikEdit what node we're 
  134.                                 on.
  135.  
  136. cd\bbs\max\%2                      <-  that changes to the \bbs\max\1 
  137.                                 directory, assuming the node number 
  138.                                 is 1.
  139.  
  140. copy /y msgtmp c:\bbs\max\%1>nul   <- That copies the new, edited, MSTMP
  141.                                 to MSGTMP01.$$$ (assuming node 1), 
  142.                                 which is what Maximus will be looking 
  143.                                 for. ( >nul again suppresses output from 
  144.                                 copy)
  145.  
  146.  
  147.  
  148.                     Configuring Maximus
  149.  
  150.  
  151. Now we reach the final step, setting up Maximus to use the external editor!
  152.  
  153. This is very simple, all you must do is edit MAX.CTL, and find the line Local 
  154. Editor.  (there will likely be two examples, both commented out)  Add a line 
  155. (uncommented, ofc), that looks like the following:
  156.  
  157. Local Editor         @Command.Com /C C:\Bbs\QuikEdit\Quik.Bat %s %%k %%t
  158.  
  159. The @ tells Maximus to allow remote users to use this.  The Command.Com /C 
  160. will tell Maximus to call COMMAND.COM, which we must do to be able to run a 
  161. batch file. (otherwise we'd have to write a little EXE/COM file to do this 
  162. for us).  The C:\Bbs\QuikEdit\Quik.Bat is the location of our Quik.Bat file, 
  163. the %s will be translated to the file Maximus wants the message in, and 
  164. the %%k will be translated to the current node number.  %%t is translated, 
  165. of course, into the user's time remaining.
  166.  
  167.     NOTE: That it MUST be %%k, and *NOT* %k, and %%t, and *NOT* %t,
  168.          and it should be %s, *NOT* %%s
  169.  
  170. After you re-silt, I suggest you fire up a copy of Maximus locally
  171. and see if QuikEdit runs as it should!
  172.  
  173.  
  174.                     Editing ACCESS.CTL!
  175.  
  176.  
  177. Maximus, by default, does not allow any users aside from those with Sysop and 
  178. those with AsstSysop privelege levels to use the external editor either 
  179. remotely, or locally!
  180.  
  181. If, however, you have users who don't have a privelege level of Sysop or 
  182. AsstSysop (likely), and you want them to be able to use QuikEdit, make the 
  183. following changes to ACCESS.CTL..
  184.  
  185. Access Normal
  186.        Level           30
  187.        Desc            Normal
  188.        Key             N
  189.        Time            60
  190.        Cume            60
  191.        Calls           -1
  192.        LogonBaud       300
  193.        XferBaud        300
  194.        FileLimit       5000
  195.        FileRatio       0
  196.        RatioFree       1000
  197.        UploadReward    100
  198. %       LoginFile       Misc\PrivN
  199. %       Flags
  200.        MailFlags       LocalEditor Editor
  201. %       UserFlags
  202.        Oldpriv         2
  203. End Access
  204.  
  205. That is my definition for the Normal access level (which all users on my BBS 
  206. aside from me have).  Note the line specifying MailFlags.
  207.  
  208. LocalEditor tells Maximus to allow this privelege class to use the external 
  209. editor if they're logged on locally.
  210.  
  211. Editor tells Maximus to allow this privelege class to use the external editor 
  212. if they're calling remotely. (and your external editor has a @ before the 
  213. pathname, such as we have given QuikEdit)
  214.  
  215.  
  216. You'll want to make these changes for all privelege levels you
  217. wish to have access to QuikEdit.
  218.  
  219. Once this is done, you should be all set with QuikEdit & Maximus.
  220.  
  221.  
  222.  
  223. After following the above carefully, your Maximus v3 system should
  224. now have nearly complete QuikEdit capabilities!
  225.  
  226. The only incomplete part, will be MSGINF.  Since the MSGINF file
  227. really is only significant for Classic (AKA Hudson) & Goldbase
  228. platforms (QuickBBS, RemoteAccess, Proboard, etc) Maximus sysops
  229. should be fine without it.
  230.  
  231.